SftTree/OCX 7.0

Converting To Version 7.0

Softel vdm, Inc.

If you are upgrading from version 5.0 (or newer), this topic does not apply. This topic documents changes introduced with version 5.0 and is applicable only if you are upgrading from version 4.5 (or older). SftTree/OCX 5.0 and newer versions introduce many new objects, which simplify use of the control by using multiple objects instead of a single object model.

All methods and properties (even those marked "Deprecated") are still available, so it is not necessary to convert to the new object model and pre-5.0 applications can easily upgrade to 7.0 without conversion. The new object mode is however recommended for any new development.

The SftTree object represents the control.  Through this object, other objects can be accessed which describe individual parts of the control.  For example, the SftTreeItem object represents an individual item and its attributes.  For a complete list of all available objects, please see "Object Hierarchy".

To eliminate any conversion process, SftTree/OCX 7.0 still supports the "flat" object model used by earlier versions of the product.  The documentation also continues to document all methods and properties, but some are marked as "Deprecated". These should no longer be used for new development and the new "object oriented" form should be used instead.

The following is a complete list of deprecated methods and properties. You are encouraged to use the new form instead:

 


Old Form
(SftTree/OCX 4.5 and older)

New Form
(SftTree/OCX 5.0 and newer)

AddItem

Items.Add

BackColor

Items.BackColor

BackColorOdd

Items.BackColorOdd

CalcLimit

Items.CalcLimit

CalcOptimalColumnWidth

Column.OptimalWidth

CalcOptimalRowHeaderWidth

RowHeaders.OptimalWidth

Cell3D

Items.Cell3D

CellBackColor

Cell.BackColor

CellEditLimit 1)

See Cell Editing

CellEditStyle 1)

See Cell Editing

CellEventHandling 1)

See Cell Editing

CellForeColor

Cell.ForeColor

CellFont

Cell.Font

CellItemData

Cell.Data

CellItemDataString

Cell.DataString

CellPicture

Cell.Image.Picture

CellPictureAlign

Cell.ImageHAlign
Cell.ImageVAlign

CellPictureH

Cell.Image.PictureH

CellSelectBackColor

Cell.SelectBackColor

CellSelectForeColor

Cell.SelectForeColor

CellText

Cell.Text

CellTextAlign

Cell.TextHAlign
Cell.TextVAlign

CharSearchColumn

Items.CharSearchColumn

CharSearchMode

Items.CharSearchMode

Clear

Items.Clear

ClearCellPictures

Items.ClearCellImages

ClearItemPictures

Items.ClearItemImages

ClearLabelPictures

Items.ClearLabelImages

ClearRowHeaderPictures

RowHeaders.ClearImages

ColHeaderAppearance

Headers.Appearance

ColHeaderBackColor

Headers.BackColor

ColHeaderButton

Headers.Pressed

ColHeaderEnabled

Header.Enabled

ColHeaderFont

Headers.Font

ColHeaderBackColor

Headers.BackColor

ColHeaderForeColor

Headers.ForeColor

ColHeaderGrayedColor

Headers.GrayedColor

ColHeaderHilightColor

Headers.HilightColor

ColHeaderShadowColor

Headers.ShadowColor

Collapse

Item.Collapse
Items.Collapse

ColumnBackColor

Column.BackColor

ColumnButtonRemainUp

Header.RemainUp

ColumnForeColor

Column.ForeColor

ColumnMinWidth

Column.MinWidth

ColumnPicture

Header.Image.Picture

ColumnPictureAlign

Header.ImageHAlign
Header.ImageVAlign

ColumnPictureH

Header.Image.PictureH

Columns

ColumnsObj.Count

ColumnSelectBackColor

Column.SelectBackColor

ColumnSelectForeColor

Column.SelectForeColor

ColumnStyle

Column.CellHAlign
Column.CellVAlign
Column.CellMultiline
Column.ToolTip
Column.CellWordWrap
Header.Locked
Header.KeepPosition
Column.Merge
Column.MergeInto

ColumnText

Header.Text

ColumnTextStyle

Header.TextHAlign
Header.TextVAlign

ColumnWidth

Column.Width

CopyItem

Items.Copy

CopyItemDataString

n/a

CopyItems

Items.Copy

CrossColumnResize

Headers.Resizable

DeleteDependents

Item.DeleteDependents

DependentCount

Item.DependentCount
Item.DependentAllCount

DisplayColumn

Column.DisplayPosition
ColumnsObj.DisplayPosition

DropHighlight

Items.DropHighlight

DropHighlightColor

Items.DropHighlightColor

DropHighlightStyle

Items.DropHighlightStyle

Expand

Item.Expand
Items.Expand

FindItemData

Items.FindData

FindItemDataString

Items.FindDataString

FindString

Items.FindCellText

FindStringExact

Items.FindCellTextExact

FirstDependent

Item.FirstDependent

FirstDisplayColumn

ColumnsObj.FirstDisplayColumn

FirstDisplayColumn2

ColumnsObj.FirstDisplayColumn2

FirstSibling

Item.FirstSibling

FlybyHighlight

Items.FlybyHighlightStyle

ForeColor

Items.ForeColor

ForeColorOdd

Items.ForeColorOdd

GetCellColorSample

Cell.Image.GetColorSample

GetCellEditSelection 1)

See Cell Editing

GetCellPictureImage

Cell.Image.GetImageList

GetCellPicturePos

Cell.GetImagePosition

GetCellPicturePosPix

Cell.GetImagePositionPix

GetCellPos

Cell.GetPosition

GetCellPosPix

Cell.GetPositionPix

GetCellTextPos

Cell.GetTextPosition

GetCellTextPosPix

Cell.GetTextPositionPix

GetHeaderPos

Header.GetPosition
Headers.GetPosition

GetHeaderPosPix

Header.GetPositionPix
Headers.GetPositionPix

GetItemPictureImage

Item.Image.GetImageList

GetItemPos

Item.GetPosition

GetItemPosPix

Item.GetPositionPix

GetNextShown

Items.FirstShown
Item.NextShown

GetPrevShown

Items.LastShown
Item.PrevShown

GetSplitterPos

Splitter.GetPosition

GetSplitterPosPix

Splitter.GetPositionPix

GrayedColor

Items.GrayedColor

GridHorizontalColor

Items.GridHorizontalColor

GridStyle

Items.GridStyle

GridVerticalColor

Items.GridVerticalColor

HilightColor

Items.HilightColor

HitTest

Items.HitTest

HitTestPix

Items.HitTestPix

HorizontalExtent

Items.HorizontalExtent

HorizontalExtent2

Items.HorizontalExtent2

HorizontalOffset

Items.HorizontalOffset

HorizontalOffset2

Items.HorizontalOffset2

InheritBgColor

ColumnsObj.InheritBgColor

InsertItem

Items.Insert

IntegralHeight

MakeIntegralHeight

ItemData

Item.Data

ItemDataFloat

Item.DataFloat

ItemDataObject

Item.DataObject

ItemDataString

Item.DataString

ItemDataTag

Item.DataTag

ItemEditFont 1)

See Cell Editing

ItemExpand

Item.Expanded

ItemExpandable

Item.Expandable

ItemExpandAll

Item.Collapse
Item.Expand

ItemHeight

Item.Height
Items.Height

ItemHeight1

Item.Height
Items.Height

ItemID

Item.ID

ItemIndex

Items.ItemIndex

ItemLevel

Item.Level

ItemLines

Items.Lines

ItemPicture

Item.Image.Picture

ItemPictureAlign

Items.ItemImageAlign

ItemPictureExpandable

Items.ItemImageExpandable.Picture

ItemPictureExpandableH

Items.ItemImageExpandable.PictureH

ItemPictureExpanded

Items.ItemImageExpanded.Picture

ItemPictureExpandedH

Items.ItemImageExpanded.PictureH

ItemPictureH

Item.Image.PictureH

ItemPictureLeaf

Items.ItemImageLeaf.Picture

ItemPictureLeafH

Items.ItemImageLeaf.PictureH

ItemShown

Item.Shown

ItemsShown

Items.Shown

ItemsShownComplete

Items.ShownComplete

ItemStatus

Item.Enabled

ItemStyle

Items.Style

LabelPicture

Item.LabelImage.Picture

LabelPictureH

Item.LabelImage.PictureH

LastDependent

Item.LastDependent

LastDisplayColumn

ColumnsObj.LastDisplayColumn

LastDisplayColumn2

ColumnsObj.LastDisplayColumn2

LastSibling

Item.LastSibling

LeftWindow

Splitter.LeftWindow

List

Cell.Text

ListCount

Items.Count

ListIndex

Items.Current

ListSelection

Items.Selection

ListSelection1

Items.Selection

MakeCellVisible

Cell.MakeVisible

MakeColumnOptimal

Column.MakeOptimal
ColumnsObj.MakeOptimal

MakeColumnVisible

Column.MakeVisible

MakeRowHeaderOptimal

RowHeaders.MakeOptimal

MakeRowVisible

Item.MakeVisible

MakeSplitterOptimal

Splitter.MakeOptimal

MoveColumn

ColumnsObj.Move

MoveItem

Items.Move

MoveItems

Items.Move

MultilineHeader

Headers.Multiline

MultiSelect

Items.MultiSelect

NextSibling

Item.NextSibling

NoFocusStyle

Items.NoFocusStyle

NoSelection

Items.SelectionArea

OpenEnded

ColumnsObj.OpenEnded

OpenEnded2

ColumnsObj.OpenEnded2

OverheadWidth

ColumnsObj.OverheadWidth

Parent

Item.Parent

PlusMinusPictureExpandable

Items.PlusMinusImageExpandable

PlusMinusPictureExpandableH

Items.PlusMinusImageExpandable.PictureH

PlusMinusPictureExpanded

Items.PlusMinusImageExpanded

PlusMinusPictureExpandedH

Items.PlusMinusImageExpanded.PictureH

PlusMinusPictureLeaf

Items.PlusMinusImageLeaf

PlusMinusPictureLeafH

Items.PlusMinusImageLeaf.PictureH

PostEdit

EditEnded

PrevSibling

Item.PrevSibling

RealColumn

ColumnsObj.ColumnIndex

RecalcHorizontalExtent

Items.RecalcHorizontalExtent

RemoveItem

Items.Remove

ReorderColumns

Headers.Reorderable

ResizeColumn

Headers.ResizeColumn

ResizeHeader

Headers.Resizable

RightWindow

Splitter.RightWindow

RowBackColor

RowHeader.BackColor

RowColButtonDown

RowColumnHeader.ButtonDown

RowColButtonRemainUp

RowColumnHeader.RemainUp

RowColHeaderAppearance

RowColumnHeader.Appearance

RowColHeaderBackColor

RowColumnHeader.BackColor

RowColHeaderEnabled

RowColumnHeader.Enabled

RowColHeaderForeColor

RowColumnHeader.ForeColor

RowColHeaderGrayedColor

RowColumnHeader.GrayedColor

RowColHeaderHilightColor

RowColumnHeader.HilightColor

RowColHeaderShadowColor

RowColumnHeader.ShadowColor

RowColPicture

RowColumnHeader.Image.Picture

RowColPictureH

RowColumnHeader.Image.PictureH

RowColPictureAlign

RowColumnHeader.ImageHAlign
RowColumnHeader.ImageVAlign

RowColText

RowColumnHeader.Text

RowColTextStyle

RowColumnHeader.TextHAlign
RowColumnHeader.TextVAlign

RowForeColor

RowHeader.ForeColor

RowHeaderAppearance

RowHeaders.Appearance

RowHeaderBackColor

RowHeaders.BackColor

RowHeaderButtonRemainUp

RowHeaders.RemainUp

RowHeaderEnabled

RowHeaders.Enabled

RowHeaderFont

RowHeaders.Font

RowHeaderForeColor

RowHeaders.ForeColor

RowHeaderGrayedColor

RowHeaders.GrayedColor

RowHeaderHilightColor

RowHeaders.HilightColor

RowHeaderLines

RowHeaders.Lines

RowHeaderSelectBackColor

RowHeaders.SelectBackColor

RowHeaderSelectForeColor

RowHeaders.SelectForeColor

RowHeaderShadowColor

RowHeaders.ShadowColor

RowHeaderTextStyle

RowHeaders.TextHAlign
RowHeaders.TextVAlign

RowHeaderWidth

RowHeaders.Width

RowPicture

RowHeader.Image.Picture

RowPictureH

RowHeader.Image.PictureH

RowPictureAlign

RowHeader.ImageHAlign
RowHeader.ImageVAlign

RowSelectBackColor

RowHeader.SelectBackColor

RowSelectForeColor

RowHeader.SelectForeColor

RowText

RowHeader.Text

RowTextAlign

RowHeader.TextHAlign
RowHeader.TextVAlign

ScrollTips

Items.ScrollTips

SelCount

Items.SelectionCount

SelectBackColor

Items.SelectBackColor

SelectBackColorNoFocus

Items.SelectBackColorNoFocus

Selected

Item.Selected

SelectForeColor

Items.SelectForeColor

SelectForeColorNoFocus

Items.SelectForeColorNoFocus

SelectionArea

Items.SelectionArea

SelectionGroupEnd

Items.SelectionGroupEnd

SelectionGroups

Items.SelectionGroups

SelectionGroupStart

Items.SelectionGroupStart

SelectRange

Items.SelectRange

SelectStyle

Items.SelectStyle

SetCellColorSample

Cell.Image.SetColorSample

SetCellEditSelection 1)

See Cell Editing

SetCellPictureImage

Cell.Image.SetImageList

SetItemPictureImage

Item.Image.SetImageList

ShadowColor

Items.ShadowColor

ShowFocusRectangle

Items.ShowFocusRectangle

SortDependents

Items.SortDependents

SplitColumn

Splitter.Column

SplitterBar

Splitter.Visible

SplitterOffset

Splitter.Offset

SplitterResizeMode

Splitter.ResizeMode

SplitterWidth

Splitter.WidthPix

StartCombo 1)

See Cell Editing

StartComboEdit 1)

See Cell Editing

StartEdit 1)

See Cell Editing

ToolTipAlways

Items.ToolTipAlways

ToolTipBackColor

Items.ToolTipBackColor

ToolTipForeColor

Items.ToolTipForeColor

ToolTipsUseEntireCell

Items.ToolTipsUseEntireCell

TopIndex

Items.TopIndex

TopParent

Item.TopParent

TreeLineColor

Items.TreeLineColor

TreeLineGrayedColor

Items.TreeLineGrayedColor

TreeLineStyle

Items.TreeLineStyle

VirtualItem.CellBackColor

VirtualItem.Item.Cell.BackColor

VirtualItem.CellFont

VirtualItem.Item.Cell.Font

VirtualItem.CellForeColor

VirtualItem.Item.Cell.ForeColor

VirtualItem.CellPicture

VirtualItem.Item.Cell.Image.Picture

VirtualItem.CellPictureAlign

VirtualItem.Item.Cell.ImageHAlign
VirtualItem.Item.Cell.ImageVAlign

VirtualItem.CellPictureH

VirtualItem.Item.Cell.Image.PictureH

VirtualItem.CellSelectBackColor

VirtualItem.Item.Cell.SelectBackColor

VirtualItem.CellSelectForeColor

VirtualItem.Item.Cell.SelectForeColor

VirtualItem.CellText

VirtualItem.Item.Cell.Text

VirtualItem.CellTextAlign

VirtualItem.Item.Cell.TextHAlign
VirtualItem.Item.Cell.TextVAlign

VirtualItem.ColumnCount

ColumnsObj.Count

VirtualItem.Enabled

VirtualItem.Item.Enabled

VirtualItem.ItemData

VirtualItem.Item.Data

VirtualItem.ItemDataFloat

VirtualItem.Item.DataFloat

VirtualItem.ItemDataObject

VirtualItem.Item.DataObject

VirtualItem.ItemDataString

VirtualItem.Item.DataString

VirtualItem.ItemDataTag

VirtualItem.Item.DataTag

VirtualItem.ItemID

VirtualItem.Item.ID

VirtualItem.ItemPicture

VirtualItem.Item.Image.Picture

VirtualItem.ItemPictureH

VirtualItem.Item.Image.PictureH

VirtualItem.LabelImage.Picture

VirtualItem.Item.LabelImage.Picture

VirtualItem.LabelImage.PictureH

VirtualItem.Item.LabelImage.PictureH

VirtualItem.RowBackColor

VirtualItem.Item.RowHeader.BackColor

VirtualItem.RowForeColor

VirtualItem.Item.RowHeader.ForeColor

VirtualItem.RowIndex

VirtualItem.Item.ItemIndex

VirtualItem.RowPicture

VirtualItem.Item.RowHeader.Image.Picture

VirtualItem.RowPictureAlign

VirtualItem.Item.RowHeader.ImageHAlign
VirtualItem.Item.RowHeader.ImageVAlign

VirtualItem.RowPictureH

VirtualItem.Item.RowHeader.Image.PictureH

VirtualItem.RowSelectBackColor

VirtualItem.Item.RowHeader.SelectBackColor

VirtualItem.RowSelectForeColor

VirtualItem.Item.RowHeader.SelectForeColor

VirtualItem.RowText

VirtualItem.Item.RowHeader.Text

VirtualItem.RowTextAlign

VirtualItem.Item.RowHeader.TextHAlign
VirtualItem.Item.RowHeader.TextVAlign

VirtualItem.SetCellColorSample

VirtualItem.Item.Cell.Image.SetColorSample

VirtualItem.SetCellPictureImage

VirtualItem.Item.Cell.Image.SetImageList

VirtualItem.SetItemPictureImage 

VirtualItem.Item.Image.SetImageList

VirtualPictures

VirtualImageSizes

1) These methods and properties continue to be used with Internet Explorer as it does not support the new cell editing mechanisms introduced with SftTree/OCX 5.0.

See Also Object Hierarchy


Feedback / comments / error reports for this topic
© 2015 - Softel vdm, Inc. - www.softelvdm.com